package com.luoshizhen.lease.web.app.controller.room;


import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.luoshizhen.lease.common.result.Result;
import com.luoshizhen.lease.web.app.service.RoomInfoService;
import com.luoshizhen.lease.web.app.vo.room.RoomDetailVo;
import com.luoshizhen.lease.web.app.vo.room.RoomItemVo;
import com.luoshizhen.lease.web.app.vo.room.RoomQueryVo;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.luoshizhen.lease.web.app.vo.room.RoomDetailVo;
import com.luoshizhen.lease.web.app.vo.room.RoomItemVo;
import com.luoshizhen.lease.web.app.vo.room.RoomQueryVo;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@Tag(name = "房间信息")
@RestController
@RequestMapping("/app/room")
public class RoomController {

    @Autowired
    RoomInfoService service;

    /**
     * 分页查询房间列表
     *
     * @param current 当前页码，用于指定从哪一页开始查询
     * @param size    每页记录数，用于限制每页返回的记录数量
     * @param queryVo 查询条件对象，包含各种查询参数
     * @return 返回分页后的房间列表信息
     */
    @Operation(summary = "分页查询房间列表")
    @GetMapping("pageItem")
    public Result<IPage<RoomItemVo>> pageItem(@RequestParam long current, @RequestParam long size, RoomQueryVo queryVo) {
        // 创建分页对象，传入当前页码和每页记录数
        Page<RoomItemVo> page = new Page<>(current, size);
        // 调用服务方法，根据查询条件分页查询房间列表
        IPage<RoomItemVo> list = service.pageRoomItemByQuery(page, queryVo);
        // 返回查询结果，封装为统一的响应对象
        return Result.ok(list);
    }

    /**
     * 根据房间ID获取房间详细信息
     *
     * 此方法通过房间的唯一标识ID，从服务层获取房间的详细信息，并以Result对象封装后返回
     * 主要用于前端界面展示房间详细信息的场景，例如房间详情页面等
     *
     * @param id 房间的唯一标识符，用于定位特定的房间信息
     * @return 返回一个Result对象，其中包含请求的房间详细信息
     */
    @Operation(summary = "根据id获取房间的详细信息")
    @GetMapping("getDetailById")
    public Result<RoomDetailVo> getDetailById(@RequestParam Long id) {
        RoomDetailVo roomInfo = service.getDetailById(id);
        return Result.ok(roomInfo);
    }

    /**
     * 根据公寓id分页查询房间列表
     *
     * @param current 当前页码
     * @param size    每页大小
     * @param id      公寓id
     * @return 分页查询结果
     */
    @Operation(summary = "根据公寓id分页查询房间列表")
    @GetMapping("pageItemByApartmentId")
    public Result<IPage<RoomItemVo>> pageItemByApartmentId(@RequestParam long current, @RequestParam long size, @RequestParam Long id) {
        // 创建分页对象并设置分页参数
        IPage<RoomItemVo> page = new Page<>(current, size);
        // 调用服务方法，根据公寓id进行分页查询
        IPage<RoomItemVo> result = service.pageItemByApartmentId(page, id);
        // 返回查询结果
        return Result.ok(result);
    }
}
